C#でSystem.Drawingオブジェクトから読み取る方法#

IronOCRはBitmapやImageのようなSystem.DrawingオブジェクトをOcrImageInputでラッピングすることにより、System.Drawingオブジェクトからテキストを読み取ることを可能にし、Windows、macOS、Linuxプラットフォーム上の.NETアプリケーションにシームレスなOCR機能を提供します。

System.Drawing.Bitmapは、ビットマップ イメージの操作に使用される .NET Framework のクラスです。 ビットマップ イメージを作成、操作、表示するためのメソッドとプロパティを提供します。

System.Drawing.Imageは、.NET Framework 内のすべての GDI+ イメージ オブジェクトの基本クラスです。 これは、 System.Drawing.Bitmapを含むさまざまな画像タイプの親クラスです。

IronSoftware.Drawing.AnyBitmapは、もともと Iron Software によって開発されたオープンソース ライブラリであるIronDrawingのビットマップ クラスです。 これは、C# ソフトウェア エンジニアが Windows、macOS、Linux プラットフォーム上の .NET プロジェクトでSystem.Drawing.Commonを置き換えるのに役立ちます。

クイックスタート: System.Drawing.Bitmap からテキストを読み取る

1つのステートメントで、IronTesseractを作成し、OcrImageInputでラップされたSystem.Drawing.Bitmapを送り、すべてのテキストを抽出します。 このクイックスタート例では、IronOCRが最小限のセットアップで画像を読みやすいテキストに変換する方法を示します。

```cs:title=テキストを1行で抽出する var result = new IronOcr.IronTesseract().Read(new IronOcr.OcrImageInput(new System.Drawing.Bitmap("image.png")))；

<div class="hsg-featured-snippet">
    <h3>最小限のワークフロー（5ステップ）</h3>
    <ol>
        <li><a class="js-modal-open" data-modal-id="trial-license-after-download" href="https://nuget.org/packages/IronOcr/">System.Drawing オブジェクトを読み取るための C# ライブラリをダウンロードします。</a></li>
        <li>Obtain System.Drawing objects such as `Bitmap` and `Image`</li>
        <li>Construct the `OcrImageInput` class using the acquired data</li>
        <li>Utilize `AnyBitmap` from Iron Software for Linux and macOS</li>
        <li>切り抜き領域を指定して読み込みエリアを定義する</li>
    </ol>
</div>

<br class="clear">

## System.Drawing.Bitmapから読み取るには?

<!-- TODO: ここに画像を追加 -->.
<!-- !![IronPDFでsystem.drawing.bitmapから読み込む方法を実演しているスクリーンショット](/static-assets/images/TODO/how-do-i-read-from-system-drawing-bitmap-step_screenshot.webp) --> <a href="/static-assets/images/TODO/how-do-i-read-from-system-drawing-bitmap-step_screenshot.webp">Screenshot demonsting how do i read from system.drawing.bitmap?
<!ステップバイステップのプロセスを示すスクリーンショット -->。

まず、**`IronTesseract`**クラスをインスタンス化して、OCRを実行します。 さまざまなメソッドのいずれかから`System.Drawing.Bitmap`を作成します。 コード例では、ファイルパスが使用されています。

次に、 `using`ステートメントを使用して`OcrImageInput`オブジェクトを作成し、 `System.Drawing.Bitmap`オブジェクトからの画像を渡します。 最後に、 `Read`メソッドを使用して OCR を実行します。

```csharp
:path=/static-assets/ocr/content-code-examples/how-to/input-system-drawing-read-bitmap.cs

System.Drawing.Imageから読み取るには?

. 。 。 `System.Drawing.Image`からの読み取りは、`Image`で`OcrImageInput`オブジェクトを作成し、`Read`メソッドを使用して標準的なOCR処理を実行するのと同じくらい簡単です。 ```csharp :path=/static-assets/ocr/content-code-examples/how-to/input-system-drawing-read-image.cs ``` ### OCRのイメージとビットマップの違いは何ですか? `System.Drawing.Bitmap`はビットマップ画像に特化した実装ですが、`System.Drawing.Image`はJPEG、PNG、GIF、TIFFを含むさまざまな画像フォーマットを表現できる抽象ベースクラスです。 OCRの目的のために、IronOCRは`OcrImageInput`を通して両方を同じように扱いますが、`Image`は異なるフォーマットを扱うときにより柔軟性を提供します。 `Bitmap`はピクセルレベルの操作機能を提供し、`Image`は一般的な画像処理に適しています。 どちらもIronOCRの先進的なTesseract 5エンジンで同様に機能します。どちらを選ぶかはOCRの性能よりも幅広いアプリケーションのニーズによります。 ### なぜ他の読み込み方法ではなく Image.FromFile を使用するのですか? `Image.FromFile`は、ディスクから画像を読み込むための最も単純で直接的な方法です。 画像形式を自動的に検出し、ファイルの読み込み処理を行います。 `Image.FromStream`のような代替メソッドは、Webアプリケーションやメモリストリームを扱う場合に適しています。 `Image.FromFile`は、`Image`が破棄されるまでファイルをロックします。 高いパフォーマンスや同時アクセスが必要な制作シナリオでは、まず画像をメモリストリームにロードすることを検討してください。[Multithreaded Tesseract OCR](https://ironsoftware.com/csharp/ocr/examples/csharp-tesseract-multithreading-for-speed/) の例は、同時画像処理のベスト プラクティスを示しています。 ## IronSoftware.Drawing.AnyBitmapから読み取るにはどうすればよいですか? 同様に、 `AnyBitmap`オブジェクトを作成または取得した後、 `OcrImageInput`クラスを構築できます。 コンストラクタは、データをインポートするために必要なすべてのステップを処理します。 以下のコード例でこれを示します。 ```csharp :path=/static-assets/ocr/content-code-examples/how-to/input-system-drawing-read-anybitmap.cs ``` ### なぜSystem.DrawingクラスではなくAnyBitmapを選択するのですか? `AnyBitmap`は、`System.Drawing`クラスと比較して、優れたクロスプラットフォーム互換性を提供します。 `System.Drawing.Common`は、.NET 6+ では Windows 以外のプラットフォームでのサポートが制限されていますが、`AnyBitmap`は Windows、Linux、および macOS 全体でシームレスに動作します。 プラットフォームに依存しない一貫したAPIを提供するため、クラウドのデプロイメントやコンテナ化されたアプリケーションに最適です。 `AnyBitmap`はまた、画像処理タスクのために特別に設計された、より優れたメモリ管理とパフォーマンスの最適化を提供します。 詳細な互換性情報については、[互換性](https://ironsoftware.com/csharp/ocr/docs/)ドキュメントを参照してください。 ### AnyBitmapはどのプラットフォームをサポートしていますか? `AnyBitmap`は、.NETが動作するすべての主要なプラットフォームをサポートしています：Windows（x86、x64、ARM）、Linux（Docker用のAlpine Linuxを含む）、macOS（IntelとApple Siliconの両方）です。 このように幅広いプラットフォームをサポートしているため、多様な環境で実行する必要がある最新の.NETアプリケーションに推奨される選択肢となっています。 特に、AWS LambdaやAzure Functionsのクラウドデプロイメントに役立ちます。 [Linux](https://ironsoftware.com/csharp/ocr/get-started/linux/)、[macOS](https://ironsoftware.com/csharp/ocr/get-started/mac/)、[Docker](https://ironsoftware.com/csharp/ocr/get-started/docker/)環境のガイドでは、プラットフォーム固有のセットアップについて詳しく説明しています。 ### AnyBitmapはメモリ管理をどのように処理しますか? `AnyBitmap`は、自動ガベージコレクション統合と明示的な廃棄パターンを通して、効率的なメモリ管理を実装しています。 頻繁に割り当てられるバッファにメモリプーリングを使用し、パフォーマンス向上のためにコピーオンライトセマンティクスを実装しています。 ファイル ロックを保持できる `System.Drawing.Bitmap` とは異なり、`AnyBitmap` は画像を完全にメモリにロードし、ファイル アクセスの問題を防ぎます。 また、高スループットのシナリオでメモリ使用量をより適切に制御できるようにします。 大量の画像を処理するアプリケーションでは、`AnyBitmap` のメモリ効率により、全体的なメモリ フットプリントを大幅に削減できます。 移行のヒントについては、[System.Drawing.Common Alternatives](https://ironsoftware.com/csharp/ocr/troubleshooting/system-drawing-common-ironocr/) ガイドを参照してください。 ## スキャン領域を指定するにはどうすればよいですか? `OcrImageInput`クラスの構築では、スキャンする領域を指定できます。 これにより、OCR 用に画像ドキュメントの特定の領域を定義できます。 画像ドキュメントによっては、スキャン領域を指定することでパフォーマンスが大幅に向上することがあります。 提供されたコード例では、章番号とタイトルだけが抽出されています。 ```csharp :path=/static-assets/ocr/content-code-examples/how-to/input-images-read-specific-region.cs ``` ### より良いパフォーマンスを得るためには、いつリージョン スキャンを使用すべきですか? リージョンスキャンは、一貫したドキュメントレイアウトの特定の領域のテキストだけが必要な場合に、パフォーマンスを劇的に向上させます。 一般的な使用例としては、ヘッダー、フォームフィールド、請求書の合計、IDカード情報の抽出などがあります。 パフォーマンスが最も向上するのは、テキストの占める割合が小さい大きな画像です。 3000x4000ピクセルの請求書の場合、総額の領域だけをスキャンすると、全ページOCRよりも10～20倍速くなります。 また、リージョンスキャンは、他の領域からの潜在的なノイズを除去することで、精度を向上させます。 リージョンベースの例については、[Content Areas & Crop Regions with PDFs](https://ironsoftware.com/csharp/ocr/troubleshooting/crop-regions-rectangles/)ガイドをご覧ください。 ### 自分の地域の正しい座標を決定するにはどうすればよいですか? 座標を決定するには、`Rectangle` が (X, Y, Width, Height) フォーマットを使用し、(0,0) が左上隅であることを理解する必要があります。 まず、カーソル座標を表示する画像エディタで画像を開いてください。 あるいは、IronOCRのデバッグ機能を使って、検出されたテキスト領域を視覚化してください。 ダイナミックレイアウトの場合、まずIronOCRを使ってフルスキャンを行い、`OcrResult`を解析してプログラム的にテキスト位置を見つけることを検討してください。 [Highlight Texts for Debugging](https://ironsoftware.com/csharp/ocr/examples/highlight-texts-for-debugging/) の例では、正確な座標決定のために OCR 領域を視覚化する方法を示しています。 ### 領域が画像の境界を超えるとどうなりますか? 指定された領域が画像の境界を超えた場合、IronOCRは自動的に有効な画像領域にクリップします。 例えば、画像が1000x1000ピクセルで、矩形を(900, 900, 200, 200)で指定した場合、IronOCRは(900, 900)から(1000, 1000)までの領域のみを処理します。 この自動クリッピングはエラーを防ぎますが、座標が正しくない場合、テキストの抽出が不完全になる可能性があります。 常に、実際の画像寸法と照らし合わせて、リージョンを検証してください。 動的な画像サイズについては、固定ピクセルではなく、パーセンテージで領域を計算してください。 [OCR Region of an Image](https://ironsoftware.com/csharp/ocr/how-to/ocr-region-of-an-image/) ガイドでは、安全なリージョン処理の例をより多く提供しています。 ### OCR結果